Spectator Mode

CocoFFA includes a full-featured spectator system that allows players to watch ongoing arena matches.

Commands

Command	Description
/ffa spectate <arena>	Start spectating an arena
/ffa leavespectate	Stop spectating

Configuration

plugins/CocoFFA/config.yml

spectator:
  staff-can-see: true          # Staff can see spectators
  exit-gamemode: "SURVIVAL"    # Gamemode when leaving spectator

  items:
    player-selector:
      material: "COMPASS"
      name: "&ePlayer Selector"
      lore:
        - "&fRight-click to teleport to players"
        - "&fin the arena you're spectating"

    leave-spectate:
      material: "BARRIER"
      name: "&cLeave Spectate"
      lore:
        - "&fRight-click to stop spectating"
        - "&fand return to spawn"

Spectator Items

When spectating, players receive special items:

🧭 Player Selector (Compass)

Right-click to open a GUI showing all players in the arena. Click on a player to teleport to them.

🚫 Leave Spectate (Barrier)

Right-click to stop spectating and return to spawn.

Features

• Invisible to players - Spectators cannot be seen by arena participants
• No collision - Spectators can fly through players and blocks
• Command restrictions - Spectators cannot use most commands
• Auto-exit - Spectators are removed when the arena ends
• Staff visibility - Staff members can see other spectators (configurable)

Permissions

Permission	Description
cocoffa.spectate	Allows spectating arenas (default: true)

Messages

plugins/CocoFFA/locale/messages_en.yml

spectate:
  already-in-arena: "&fYou cannot spectate while in an arena!"
  already-spectating: "&fYou are already spectating an arena"
  arena-not-found: "&fArena &#00F7DD{arena_name} &fnot found"
  arena-not-started: "&fArena &#00F7DD{arena_name} &fis not started"
  success: "&fYou are now spectating arena &#00F7DD{arena_name}"
  arena-ended: "&fThe arena has ended. Removed from spectator mode."
  teleported-to-player: "&fTeleported to &#00F7DD{player_name}"
  command-blocked: "&fYou cannot use commands while spectating"

leavespectate:
  not-spectating: "&fYou are not spectating any arena"
  success: "&fYou have stopped spectating"

GUI Configuration

Customize the spectator player selector GUI in plugins/CocoFFA/guis/spectator-gui.yml.